Java知识体系

Appearance

Window电脑安装运行docker服务

Windows 上推荐使用 Docker Desktop 安装运行 Docker（自带 Docker CLI、Docker Compose、图形化界面）

1、检查系统要求 ​

  • Windows 10 64 位（版本 22H2，build 19045 或更高）/ Windows 11 64 位（23H2 或更高）
  • 开启 BIOS 虚拟化（Intel VT-x 或 AMD-V），处理器需支持 SLAT
  • 内存 8GB 以上（官方硬性要求）
  • WSL 版本 2.1.5 或更高（需启用 WSL 2 功能）

可以在任务管理器 → 性能 → CPU 中查看"虚拟化"是否已启用

2、安装并启用 WSL 2 ​

以管理员身份打开 PowerShell，执行：

# 安装 WSL 2 及默认的 Linux 发行版（会自动重启）
wsl --install

安装完成后重启电脑，然后设置默认版本为 WSL 2：

wsl --set-default-version 2

验证是否安装成功：

wsl --version
wsl --status
wsl -l -v

如果 wsl --version 没有输出版本信息，说明是系统自带的旧版 WSL，执行 wsl --update 升级（需要管理员权限）

3、下载安装 Docker Desktop ​

AMD64 与 ARM64 怎么选：AMD64 对应 Intel 酷睿 / AMD 锐龙等传统 x86 处理器（绝大多数电脑）；ARM64 对应高通骁龙 X 系列等 ARM 处理器（2024 年后的 Copilot+ PC 等）。在 PowerShell 执行 echo $env:PROCESSOR_ARCHITECTURE，输出 AMD64 就下载 AMD64 版，输出 ARM64 就下载 ARM64 版，选错会导致无法运行

  • 双击安装包，安装时在 Configuration 页面勾选 Use WSL 2 instead of Hyper-V（推荐，系统只支持一种后端时会自动选中）

安装完成后，搜索并启动 Docker Desktop（不会自动启动）。首次启动需要阅读并 Accept 订阅服务协议，之后等待右下角鲸鱼图标变为稳定状态（Running）即可

4、验证安装 ​

打开 PowerShell 或 CMD，执行：

docker --version

docker compose version

# 拉取并运行一个测试镜像
docker run hello-world

看到 Hello from Docker! 输出即表示安装成功

5、配置镜像加速 ​

打开 Docker Desktop → Settings → Docker Engine，在 JSON 配置中添加 registry-mirrors：

{
  "registry-mirrors": [
    "https://docker.mirrors.sjtug.sjtu.edu.cn",
    "https://docker.m.daocloud.io"
  ]
}

点击 Apply & restart 重启生效，验证：

docker info

查看 Registry Mirrors 一栏是否出现配置的地址

镜像源不建议配置太多，保留 1-2 个稳定的即可；国内常用的加速源可参考 Linux系统安装 Docker操作 中的汇总

6、常见问题 ​

问题 1：Docker Desktop requires a newer WSL kernel version

WSL 内核版本过旧，先执行 wsl --update 升级；若系统为旧版 WSL（非 Store 版本），可下载安装 WSL2 Linux 内核更新包（MSI）： https://learn.microsoft.com/zh-cn/windows/wsl/install-manual#step-4---download-the-linux-kernel-update-package

升级完成后重启 Docker Desktop

问题 2：启动报错 WSL 2 installation is incomplete

以管理员身份重新执行：

wsl --update
wsl --set-default-version 2

问题 3：拉取镜像超时

docker: Error response from daemon: Get "https://registry-1.docker.io/v2/": net/http: request canceled while waiting for connection

按第 5 步配置镜像加速源后重启 Docker Desktop